qti3-item-player-vue3 0.1.0 → 0.1.5

Sign up to get free protection for your applications and to get access to all the features.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2024 Amp-up.io, LLC
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -76,9 +76,6 @@ npm run build
76
76
 
77
77
  ## Usage
78
78
 
79
- The [Demo TestRunner](https://github.com/amp-up-io/qti3-item-player-controller) is a good way to get familiar with QTI 3 Player usage. Specifically, please see the [TestRunner.vue](https://github.com/amp-up-io/qti3-item-player-controller/blob/main/src/views/TestRunner.vue) sub-component.
80
-
81
-
82
79
  ### 1. Import QTI 3 Player and QTI 3 Player CSS
83
80
 
84
81
  ```js
@@ -228,9 +225,14 @@ QTI 3 Player triggers a `notifyQti3ItemReady` event upon completion of the Playe
228
225
  * @description Event handler for the QTI3Player component's 'notifyQti3ItemReady'
229
226
  * event. This event is fired upon completion of the qti-assessment-item
230
227
  * component's loading of XML.
228
+ * The inner qti-assessment-item component is passed in the event.
229
+ * @param {Component} item - the qti-assessment-item component itself
231
230
  */
232
- handleItemReady () {
231
+ handleItemReady (item) {
233
232
  console.log('QTI 3 Item XML is loaded and rendered! The latest "attempt" has officially begun.')
233
+ // The item argument is the qti-assessment-item component
234
+ // with all exposed properties and methods.
235
+ this.item = item
234
236
  }
235
237
  ```
236
238
  <p align="right">(<a href="#top">back to top</a>)</p>
@@ -248,7 +250,7 @@ After item XML is loaded and an attempt has begun, a test controller may retriev
248
250
 
249
251
  * **suspendAttempt**
250
252
 
251
- This performs response validation (if `validateResponses: true`) and produces the state of all item variables. _No response processing is executed._ Typical use is when `submissionMode: "simultaneous"`.
253
+ This performs response validation (if `validateResponses: true`) and produces the state of all item variables. _No response processing is executed._ Typical use is when `submissionMode: "simultaneous"`.
252
254
 
253
255
  The `endAttempt` and `suspendAttempt` methods may take a considerable amount of time to complete. QTI 3 Player triggers the `notifyQti3EndAttemptCompleted` and `notifyQti3SuspendAttemptCompleted` events, respectively, upon completion of an `endAttempt` or a `suspendAttempt` method call.
254
256
 
@@ -705,6 +707,7 @@ The QTI3 Item Player 2022-2024 development roadmap includes all features and cap
705
707
  - [x] Support for Interaction "Review" Status
706
708
  - [x] Improved Audio Player
707
709
  - [x] Improved Video Player
710
+ - [ ] Update Quill.js to version 2.x
708
711
 
709
712
  <p align="right">(<a href="#top">back to top</a>)</p>
710
713
 
@@ -721,7 +724,7 @@ Distributed under the MIT License. See `LICENSE` for more information.
721
724
 
722
725
  ## Built With
723
726
 
724
- The QTI3 Item Player is built with the Vue.js (v2.6) framework.
727
+ The QTI3 Item Player is built with the Vue 3.4 (v3.4.34) framework and Vite.
725
728
 
726
729
  * [Vue.js](https://vuejs.org/)
727
730
 
@@ -734,7 +737,7 @@ The QTI3 Item Player is built with the Vue.js (v2.6) framework.
734
737
 
735
738
  Paul Grudnitski - paul.grudnitski@amp-up.io
736
739
 
737
- Project Link: [https://github.com/amp-up-io/qti3-item-player](https://github.com/amp-up-io/qti3-item-player)
740
+ Project Link: [https://github.com/amp-up-io/qti3-item-player-vue3](https://github.com/amp-up-io/qti3-item-player-vue3)
738
741
 
739
742
  <p align="right">(<a href="#top">back to top</a>)</p>
740
743
 
@@ -743,10 +746,10 @@ Project Link: [https://github.com/amp-up-io/qti3-item-player](https://github.com
743
746
  <!-- ACKNOWLEDGMENTS -->
744
747
  ## Acknowledgments
745
748
 
746
- This component would not be possible were it not for a fortuitous decision by the aQTI Task Force (the original name of the QTI 3 Working Group) - meeting at CITO headquarters in Arnhem, NE, January 2015 - to make the aQTI / QTI 3 specification "web component friendly".
749
+ This component would not be possible were it not for a fortuitous decision by the aQTI Task Force (the original name of the QTI 3 Working Group) - meeting at CITO headquarters in Arnhem, NE, January 2015 - to make the aQTI / QTI 3 specification "web component friendly".
747
750
 
748
751
  <p align="right">(<a href="#top">back to top</a>)</p>
749
752
 
750
753
 
751
- [license-shield]: https://img.shields.io/github/license/amp-up-io/qti3-item-player?label=License&style=for-the-badge
752
- [license-url]: https://github.com/amp-up-io/qti3-item-player/blob/main/LICENSE
754
+ [license-shield]: https://img.shields.io/github/license/amp-up-io/qti3-item-player-vue3?label=License&style=for-the-badge
755
+ [license-url]: https://github.com/amp-up-io/qti3-item-player-vue3/blob/main/LICENSE