@rakuten-rex/select v1.4.1

ReX React UI Component: select

This project is part of ReX Design System and it can be used to create UI Components compatible with:

React, HTML/CSS and Vue.js

How to install

npm install @rakuten-rex/select@1.4.1 --save

yarn add @rakuten-rex/select@1.4.1

Getting started

Storybook Live examples

For a complete guide of properties for React and HTML classes please visit our Storybook page:

https://rakuten-rex.github.io/select/

Storybook features

• Stories by component types
• HTML raw output
• JSX output
• Stories source code
• Knobs with multiple options

ZeroHeight Documentation

For a complete Documentation including all ReX Design System Components, Live HTML/React examples and Demos please visit:

https://rakuten-rex.github.io/

How to integrate ReX in your project

A) JavaScript modules

React component (JavaScript + CSS Styles)

For plug and play components integration.

Example:

my-component.jsx

import SelectLabel from '@rakuten-rex/select/SelectLabel';

function MyCustomComponent() {
  return (
    <SelectLabel
      id="age"
      label="Label"
      placeholder="Placeholder"
      options={[
        { text: 'Option 1', value: 'option_1' },
        { text: 'Option 2', value: 'option_2' },
        { text: 'Option 3', value: 'option_3' },
      ]}
      htmlFor="age"
    />
  );
}

Click here to see all working examples in Storybook.

CSS Styles only

For your own JavaScript integration (React, Vue, Angular, etc.) or Static HTML.

Using CSS Variables (Modern Websites and WebApps)

Example:

my-component.jsx

import '@rakuten-rex/select/SelectLabel/css';

function MyCustomComponent() {
  return (
    <div class="rex-my-component" role="presentation">
      <div class="rex-select-label">
        <label for="age" class="rex-select-label-ui">Label</label>
        <div class="rex-select">
          <select id="age" class="rex-select-native rex-select-placeholder" aria-label="Placeholder">
            <option selected="">Placeholder</option>
            <option value="option_1">Option 1</option>
            <option value="option_2">Option 2</option>
            <option value="option_3">Option 3</option>
          </select></div>
      </div>
    </div>
  );
}

Using Static CSS (Legacy Websites)

Example:

my-component.jsx

import '@rakuten-rex/select/SelectLabel/css/static';

function MyCustomComponent() {
  return (
    <div class="rex-my-component" role="presentation">
      <div class="rex-select-label">
        <label for="age" class="rex-select-label-ui">Label</label>
        <div class="rex-select">
          <select id="age" class="rex-select-native rex-select-placeholder" aria-label="Placeholder">
            <option selected="">Placeholder</option>
            <option value="option_1">Option 1</option>
            <option value="option_2">Option 2</option>
            <option value="option_3">Option 3</option>
          </select></div>
      </div>
    </div>
  );
}

Click here to see all working examples in Storybook.

Sass mixins

For your own customization of styles (React, Vue, Angular, etc.) or Static HTML.

Example:

my-styles.scss

@import '@rakuten-rex/select/SelectLabel/sass/styles.mixin';

.my-component-with-rex-styles {
  @include rex-select-label();
}

Vue.js

A basic implementation based on HTML structure and import CSS styles into your component.

Example:

my-component.vue

<template>
    <div class="rex-my-component" role="presentation">
      <div class="rex-select-label">
        <label for="age" class="rex-select-label-ui">Label</label>
        <div class="rex-select">
          <select id="age" class="rex-select-native rex-select-placeholder" aria-label="Placeholder">
            <option selected="">Placeholder</option>
            <option value="option_1">Option 1</option>
            <option value="option_2">Option 2</option>
            <option value="option_3">Option 3</option>
          </select></div>
      </div>
    </div>
</template>
<script>
export default {
  name: 'MyComponent',
}
</script>
<style scoped>
@import "~@rakuten-rex/select/SelectLabel/css";
</style>

B) Static HTML

Copy-paste the stylesheet <link> into your <head> tag to load our CSS styles.

Using CSS Variables (Modern Websites and WebApps)

Production mode URL (recommended for Static HTML projects):

https://unpkg.com/@rakuten-rex/select@1.4.1/SelectLabel/SelectLabel.production.min.css

Development mode URL (for local testing):

https://unpkg.com/@rakuten-rex/select@1.4.1/SelectLabel/SelectLabel.development.css

Using Static CSS (Legacy Websites)

https://unpkg.com/@rakuten-rex/select@1.4.1/SelectLabel/SelectLabel.static.css

Single component integration

Add it from unpkg.com CDN (NPM) into your HTML template or HTML static page.

Example:

my-page.html

<!doctype html>
<html>
  <head>
    <meta charset="utf-8">
    <title>My Page</title>
    <!-- ReX select -->
    <link href="https://unpkg.com/@rakuten-rex/select@1.4.1/SelectLabel/SelectLabel.production.min.css" rel="stylesheet">
  </head>
  <body>
    <div class="rex-my-component" role="presentation">
      <div class="rex-select-label">
        <label for="age" class="rex-select-label-ui">Label</label>
        <div class="rex-select">
          <select id="age" class="rex-select-native rex-select-placeholder" aria-label="Placeholder">
            <option selected="">Placeholder</option>
            <option value="option_1">Option 1</option>
            <option value="option_2">Option 2</option>
            <option value="option_3">Option 3</option>
          </select></div>
      </div>
    </div>
  </body>
</html>

Documentation, source code and distribution

Project Stack

Features

Browser Support