Skip to content

canicjusz/KaiOS-native-UI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

KaiOS-native-UI

Tool for creating native-like KaiOS UI.

A gif showing demo

Installation

Include the checkboxes-radios folder, CSS and JS files into your project.

Usage

Basic template

<body>
  <div id="app">
    <div id="header">header</div>
    <div class="toast">This is a toast message</div>
    <div id="content">
      <!-- add all content of the app in here -->
    </div>
    <div class="softkeys">
      <div class="softkey softkey-left">left key</div>
      <div class="softkey softkey-center">select</div>
      <div class="softkey softkey-right">right key</div>
    </div>
  </div>
</body>

List items:

  • List item with text only
<div class="list-item focusable" tabindex="0">
  <p class="list-item__text">single line list item</p>
</div>

<div class="list-item focusable" tabindex="0">
  <p class="list-item__text">list item</p>
  <p class="list-item__subtext">secondary List</p>
</div>
  • List item with indicator
<div class="list-item-indicator focusable" tabindex="0">
  <p class="list-item-indicator__text">single line list item</p>
  <span class="list-item-indicator__indicator"></span>
</div>

<div class="list-item-indicator focusable" tabindex="0">
  <p class="list-item-indicator__text">two-lines list item</p>
  <p class="list-item-indicator__subtext">with next indicator</p>
  <span class="list-item-indicator__indicator"></span>
</div>
  • List item with icon
<div class="list-item-icon focusable" tabindex="0">
  <img src="" alt="" class="list-item-icon__icon" />
  <div class="list-item-icon__text-container">
    <p class="list-item-icon__text">single line list item</p>
  </div>
</div>

<div class="list-item-icon focusable" tabindex="0">
  <img src="" alt="" class="list-item-icon__icon" />
  <div class="list-item-icon__text-container">
    <p class="list-item-icon__text">single line list item</p>
    <p class="list-item-icon__subtext">with next indicator</p>
  </div>
</div>
  • List item with checkbox
<div class="checkbox-container">
  <p class="checkbox-container__text">checkbox list item</p>
  <p class="checkbox-container__subtext">secondary List</p>
  <input
    type="checkbox"
    tabindex="0"
    class="focusable checkbox-container__input"
  />
  <div class="checkbox-container__checkbox"></div>
</div>

Note: you can change checkbox apperance in CSS, simply navigate to the checkbox-container__checkbox class in the CSS file and provide path to other image.

  • List item with radio button
<div class="radio-container">
  <p class="radio-container__text">radio button list item</p>
  <p class="radio-container__subtext">secondary List</p>
  <input type="radio" tabindex="0" class="focusable radio-container__input" />
  <div class="radio-container__radio"></div>
</div>

Note: you can change radio apperance in CSS, simply navigate to the radio-container__radio class in the CSS file and provide path to other image.

  • List item with slider
<div class="slider-container">
  <p class="slider-container__text">alarm</p>
  <p class="slider-container__subtext">5/15</p>
  <input
    type="range"
    tabindex="0"
    min="1"
    max="15"
    value="5"
    class="slider-container__slider focusable"
  />
</div>
  • List item with progress bar
<div class="progress-container" tabindex="0">
  <label class="progress-container__label"> downloading </label>
  <progress
    value="65"
    max="100"
    class="progress-container__progress focusable"
  ></progress>
</div>

Note: make sure to add progress-container__progress--min class to the progress element upon reaching minimal value and progress-container__progress--max upon reaching maximal value. Otherwise the progress bar will not look as expected #6.

Inputs and textareas:

  • Input
<div class="input-container">
  <label class="input-container__label">label text</label>
  <input type="text" tabindex="0" class="input-container__input focusable" />
</div>
  • Textarea
<div class="textarea-container">
  <label class="textarea-container__label">label text</label>
  <textarea
    tabindex="0"
    class="textarea-container__textarea focusable"
  ></textarea>
</div>

Buttons

<div class="button-container">
  <button tabindex="0" class="button-container__button focusable">
    sign in
  </button>
  <button tabindex="0" class="button-container__button focusable">
    register
  </button>
</div>

Separator

<div class="separator">separator</div>

Softkeys

  • Softkeys with text in the middle
<div class="softkeys">
  <div class="softkey softkey-left">left key</div>
  <div class="softkey softkey-center">select</div>
  <div class="softkey softkey-right">right key</div>
</div>
  • Softkeys with icon in the middle
<div class="softkeys-icon">
  <div class="softkey softkey-left">left key</div>
  <div class="softkey softkey-center"><!-- icon --></div>
  <div class="softkey softkey-right">right key</div>
</div>

Color, textarea height, scroll, capitalization changing

Go to css file and edit values in :root

License

WTFPL

About

Tool for creating native-like KaiOS UI.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published