Rating"

From Documentation
m ((via JWB))
 
(4 intermediate revisions by the same user not shown)
Line 3: Line 3:
 
= Rating =
 
= Rating =
  
*Java API: <javadoc>org.zkoss.zkmax.zul.Rating</javadoc>
+
*Java API: <javadoc>org.zkoss.zul.Rating</javadoc>
*JavaScript API: <javadoc directory="jsdoc">zkmax.wgt.Rating</javadoc>
+
*JavaScript API: <javadoc directory="jsdoc">zul.wgt.Rating</javadoc>
[ since 8.6.0 ]
+
{{versionSince| 8.6.0}}
  
 
= Employment/Purpose =
 
= Employment/Purpose =
 
The rating component is a component that allows user selecting an rate that is smaller than the maximum number.
 
The rating component is a component that allows user selecting an rate that is smaller than the maximum number.
  
= Example =
+
= Examples =
  
 
[[File:rating.gif| center]]
 
[[File:rating.gif| center]]
 
+
== Default ==
 +
<source lang="xml" >
 +
<rating rating="3"/>
 +
</source>
 +
== Custom Icon ==
 +
<source lang="xml" >
 +
<rating iconSclass="z-icon-bolt"/>
 +
</source>
 +
=== CSS ===
 
<source lang="xml" >
 
<source lang="xml" >
 
     <style>
 
     <style>
Line 22: Line 30:
 
             opacity: 0.5;
 
             opacity: 0.5;
 
         }
 
         }
         .gift .z-rating-selected{
+
         .gift .z-rating-selected, .gift .z-rating-hover{
 
             opacity: 1;
 
             opacity: 1;
 
         }
 
         }
 
     </style>
 
     </style>
     <vlayout style="margin: 20px">
+
     <rating iconSclass="myGiftIcon" sclass="gift" rating="3"/>
        <n:h1>default</n:h1>
 
        <rating rating="3"/>
 
        <n:h1>custom icon</n:h1>
 
        <rating iconSclass="z-icon-bolt" rating="3" max="7"/>
 
        <div sclass="gift">
 
            <rating iconSclass="myGiftIcon" rating="3"/>
 
        </div>
 
    </vlayout>
 
 
</source>
 
</source>
  
=Properties and Features=
+
=Properties=
  
  
 
==IconSclass==
 
==IconSclass==
Specify the sclass name of the rating icon.
+
Specify the CSS class name of the rating icon.
  
 
==Orient==
 
==Orient==
The orientation is default to <tt>horizontal</tt>, could be changed to vertical if <tt>vertical</tt> is specified.
+
The orientation is default to <code>horizontal</code>, could be changed to vertical if <code>vertical</code> is specified.
  
 
==Rating==
 
==Rating==
This is the rating value, will have a initial value if specified to an integer larger than 0.
+
This is the rating value, which has an initial value if specified to an integer larger than 0.
  
 
==Cancelable==
 
==Cancelable==
If true, by clicking the previous rated icon again, the rating will be canceled and set 0.
+
If true, by clicking the previously rated icon again, the rating will be canceled and set to 0.
  
 
==Max==
 
==Max==
Represents the maximum number of the rating. Also, icons will be rendered as the max size.
+
Represents the maximum number of ratings. Also, icons will be rendered as the max size.
  
 
==Disabled==
 
==Disabled==
Line 67: Line 67:
 
! <center>Event Type</center>
 
! <center>Event Type</center>
 
|-
 
|-
| <center><tt>onChange</tt></center>
+
| <center><code>onChange</code></center>
 
| '''Event:''' <javadoc>org.zkoss.zk.ui.event.Event</javadoc>
 
| '''Event:''' <javadoc>org.zkoss.zk.ui.event.Event</javadoc>
 
Denotes user has rated.
 
Denotes user has rated.

Latest revision as of 09:27, 19 September 2022

Rating

Since 8.6.0

Employment/Purpose

The rating component is a component that allows user selecting an rate that is smaller than the maximum number.

Examples

Rating.gif

Default

<rating rating="3"/>

Custom Icon

 <rating iconSclass="z-icon-bolt"/>

CSS

    <style>
        .myGiftIcon:before {
            content: '🎁';
        }
        .gift .z-rating-icon{
            opacity: 0.5;
        }
        .gift .z-rating-selected, .gift .z-rating-hover{
            opacity: 1;
        }
    </style>
    <rating iconSclass="myGiftIcon" sclass="gift" rating="3"/>

Properties

IconSclass

Specify the CSS class name of the rating icon.

Orient

The orientation is default to horizontal, could be changed to vertical if vertical is specified.

Rating

This is the rating value, which has an initial value if specified to an integer larger than 0.

Cancelable

If true, by clicking the previously rated icon again, the rating will be canceled and set to 0.

Max

Represents the maximum number of ratings. Also, icons will be rendered as the max size.

Disabled

If disabled is true, it's not allowed to be rated. (Is allowed to have an initial rating.)

Readonly

If true, the rating is only readable, not changeable. (Is allowed to have an initial rating.)

Supported Events

Name
Event Type
onChange
Event: Event

Denotes user has rated.

Supported Children

* none

Version History

Last Update : 2022/09/19


Version Date Content
     



Last Update : 2022/09/19

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.