Please note that the demo page has limited functionality.
yarn add box-ui-elements or
npm install box-ui-elements
To prevent library duplication, the UI Elements require certain peer dependencies to be installed manually. For a list of required peer dependencies, see package.json.
This documentation describes how to use UI Elements in a React application using webpack. If instead you require a framework-agnostic solution, please refer to our developer documentation. You can also reference our Elements Demo App and Preview Demo App for examples of minimal React applications using ContentExplorer and ContentPreview, respectively.
* These components utilize code splitting. See the Code Splitting section for more information.
Code splitting is currently supported for some UI Elements. In order to use an Element with code splitting, you need to set it up in webpack.
Box UI Elements use SCSS stylesheets. Each of the Elements include their corresponding SCSS stylesheet to render properly. Once you
import an Element within your React app, the corresponding stylesheet will automatically get included. However, you will need to setup webpack to handle
.scss files by using the sass-loader / css-loader. This will direct webpack to properly include our SCSS files in your final CSS output. A sample configuration is shown here under the rules section.
- Desktop Chrome, Firefox, Safari, Edge (latest 2 versions)
- Limited support for Internet Explorer 11 (requires ES2015 polyfill)
- Mobile Chrome and Safari
- React 17: Box UI Elements currently supports usage in React 17 environments. Developers implementing UI Elements in React 18 may experience unexpected issues.
Copyright and License
Copyright 2016-present Box, Inc. All Rights Reserved.
Licensed under the Box Software License Agreement v.20170516. You may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.